home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat1 / ixrun.0 next >
Text File  |  1996-09-01  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. IXRUN(1)                                                 IXRUN(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        ixrun - run AmigaDOS scripts from within /bin/sh
  9.  
  10. SSYYNNOOPPSSIISS
  11.        iixxrruunn [ --qq | --qqvv | --nn | --nnvv ] filename [ arguments... ]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        _I_x_r_u_n  makes  it  possible  to  run  AmigaDOS scripts from
  15.        /bin/sh or from other Unix programs.   The  _i_x_e_m_u_l_._l_i_b_r_a_r_y
  16.        uses the first line of a file to find out to which program
  17.        it should feed the file.  Normally this  is  _/_b_i_n_/_s_h,  but
  18.        you  can  use  any program you want. Shell scripts usually
  19.        start with ##!!//bbiinn//sshh.  Unfortunately, AmigaDOS scripts use
  20.        a semi-colon to start a comment, not the ##-sign.  However,
  21.        the _i_x_e_m_u_l_._l_i_b_r_a_r_y also accepts ;;!!.  So one  would  expect
  22.        that  starting  a script with ;;!!//cc//eexxeeccuuttee would work. But
  23.        it doesn't. First of all, _c_:_e_x_e_c_u_t_e does some weird things
  24.        that  prevent  us  from using this possibility.  Secondly,
  25.        AmigaDOS won't recognize the ..kkeeyy sequence unless it is at
  26.        the  beginning  of  the script. To work around this second
  27.        problem, the _i_x_e_m_u_l_._l_i_b_r_a_r_y skips the first  line  of  the
  28.        script  if  it starts with ..kkeeyy.  So you should put the ;;!!
  29.        sequence at the second line  instead.  If  you  _d_o_n_'_t  use
  30.        ..kkeeyy,  then  you should put the ;;!!  sequence at the begin-
  31.        ning of the script as usual.
  32.  
  33.        To work around the first problem I wrote  _i_x_r_u_n,  a  small
  34.        utility  to  replace  _c_:_e_x_e_c_u_t_e.   Just  start an AmigaDOS
  35.        script with ;;!!//bbiinn//iixxrruunn (possibly preceeded by  the  ..kkeeyy
  36.        line)  and  you  can now run it from within _/_b_i_n_/_s_h or any
  37.        other Unix program.
  38.  
  39. OOPPTTIIOONNSS
  40.        --nn     Don't put quotes around the arguments.
  41.  
  42.        --qq     Put quotes around every argument that you  pass  to
  43.               your  script.  This is the default.  _i_x_r_u_n builds a
  44.               command line which starts with the filename of  the
  45.               script  (the  ffiilleennaammee  argument)  followed  by the
  46.               other arguments passed to _i_x_r_u_n.  This command line
  47.               is  executed  by  calling  the _d_o_s_._l_i_b_r_a_r_y function
  48.               _E_x_e_c_u_t_e.  That is, iixxrruunn ssccrriipptt ""HHeelllloo wwoorrlldd""  will
  49.               execute  ssccrriipptt ""HHeelllloo wwoorrlldd"", as one would expect.
  50.               But iixxrruunn --nn  ssccrriipptt  ""HHeelllloo  wwoorrlldd""  will  execute
  51.               ssccrriipptt  HHeelllloo  wwoorrlldd.  That is, the single argument
  52.               HHeelllloo wwoorrlldd has been split into two. So take  care.
  53.  
  54.        --qqvv    Debugging:  show  the  command  line that should be
  55.               executed if the option --qq was used,  without  actu-
  56.               ally executing it.
  57.  
  58.        --nnvv    Debugging:  show  the  command  line that should be
  59.               executed if the option --nn was used,  without  actu-
  60.               ally executing it.
  61.  
  62.  
  63.  
  64.                                                                 1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IXRUN(1)                                                 IXRUN(1)
  71.  
  72.  
  73. AAUUTTHHOORR
  74.        Hans Verkuil (_h_a_n_s_@_w_y_s_t_._h_o_b_b_y_._n_l)
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                                                 2
  131.  
  132.  
  133.